/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package net.micode.notes.ui; // 指定该类属于 net.micode.notes.ui 包

import android.content.Context; // 导入 Context 类，用于获取应用程序环境
import android.database.Cursor; // 导入 Cursor 类，用于访问数据库查询结果
import android.view.View; // 导入 View 类，表示用户界面元素
import android.view.ViewGroup; // 导入 ViewGroup 类，表示视图的容器
import android.widget.CursorAdapter; // 导入 CursorAdapter 类，用于将 Cursor 数据绑定到视图
import android.widget.LinearLayout; // 导入 LinearLayout 类，表示线性布局
import android.widget.TextView; // 导入 TextView 类，表示文本视图

import net.micode.notes.R; // 导入资源类 R，用于引用资源文件
import net.micode.notes.data.Notes; // 导入 Notes 类，用于访问笔记相关数据
import net.micode.notes.data.Notes.NoteColumns; // 导入 NoteColumns 类，表示笔记的列名

public class FoldersListAdapter extends CursorAdapter {
    // 定义要查询的列
    public static final String[] PROJECTION = {
            NoteColumns.ID, // 笔记的 ID 列
            NoteColumns.SNIPPET // 笔记的摘录列
    };

    public static final int ID_COLUMN = 0; // ID 列的索引
    public static final int NAME_COLUMN = 1; // 名称列的索引

    // 构造函数，初始化 FoldersListAdapter
    public FoldersListAdapter(Context context, Cursor c) {
        super(context, c); // 调用父类构造函数
        // TODO Auto-generated constructor stub
    }

    // 创建新视图
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        return new FolderListItem(context); // 返回新的 FolderListItem 视图
    }

    // 绑定视图与数据
    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        if (view instanceof FolderListItem) { // 检查视图是否为 FolderListItem 的实例
            // 获取文件夹名称，如果是根文件夹，则使用特定字符串
            String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER)
                    ? context.getString(R.string.menu_move_parent_folder)
                    : cursor.getString(NAME_COLUMN);
            ((FolderListItem) view).bind(folderName); // 绑定文件夹名称到视图
        }
    }

    // 根据位置获取文件夹名称
    public String getFolderName(Context context, int position) {
        Cursor cursor = (Cursor) getItem(position); // 获取指定位置的 Cursor
        // 检查是否是根文件夹，返回相应的名称
        return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER)
                ? context.getString(R.string.menu_move_parent_folder)
                : cursor.getString(NAME_COLUMN);
    }

    // 内部类，表示文件夹列表项视图
    private class FolderListItem extends LinearLayout {
        private TextView mName; // 声明一个 TextView 对象，用于显示文件夹名称

        // 构造函数，初始化 FolderListItem
        public FolderListItem(Context context) {
            super(context); // 调用父类构造函数
            inflate(context, R.layout.folder_list_item, this); // 从布局文件中膨胀视图
            mName = (TextView) findViewById(R.id.tv_folder_name); // 获取文件夹名称的 TextView
        }

        // 绑定文件夹名称到 TextView
        public void bind(String name) {
            mName.setText(name); // 设置 TextView 的文本为文件夹名称
        }
    }
}